.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "FACTER" "8" "April 2015" "" ""
.
.SH "NAME"
\fBfacter\fR \- Gather system information
.
.SH "SYNOPSIS"
Collect and display facts about the system\.
.
.SH "USAGE"
.
.nf

facter [\-\-color] [\-\-custom\-dir DIR] [\-d|\-\-debug] [\-\-external\-dir DIR] [\-\-help]
  [\-j|\-\-json] [\-l|\-\-log\-level LEVEL (=warn)] [\-\-no\-color] [\-\-no\-custom\-facts]
  [\-\-no\-external\-facts] [\-\-trace] [\-\-verbose] [\-v|\-\-version] [\-y|\-\-yaml]
  [fact] [fact] [\.\.\.]
.
.fi
.
.SH "DESCRIPTION"
Collect and display facts about the current system\. The library behind Facter is easy to extend, making Facter an easy way to collect information about a system\.
.
.P
If no queries are given, then all facts will be returned\.
.
.P
Many of the command line options can also be set via the HOCON config file. This file can also be used to block the collection of certain fact groups\.
.
.SH "OPTIONS"
.
.nf
      \fB\-\-color\fR                      Enables color output\.
      \fB\-\-config\fR                     A custom location for the chnfig file\.
      \fB\-\-custom-dir\fR arg             A directory to use for custom facts\.
\fB\-d, [ \-\-debug ]\fR                    Enable debug output\.
      \fB\-\-external-dir\fR arg           A directory to use for external facts\.
      \fB\-\-help\fR                       Print help and usage information\.
\fB\-j, [ \-\-json ]\fR                     Output facts in JSON format\.
      \fB\-\-show-legacy\fR                Show legacy facts when querying all facts\.
\fB\-l, [ \-\-log-level ]\fR arg (=warn)    Set logging level\.
                                   Supported levels are: none, trace, debug,
                                   info, warn, error, and fatal\.
      \fB\-\-no-color\fR                   Disables color output\.
      \fB\-\-no-custom-fact\fR             Disables custom facts\.
      \fB\-\-no-external-facts\fR          Disables external facts\.
      \fB\-\-no-ruby\fR                    Disables loading Ruby, facts requiring Ruby, and custom facts\.
      \fB\-\-trace\fR                      Enables backtraces for custom facts\.
      \fB\-\-verbose\fR                    Enables verbose (info) output\.
\fB\-v, [ \-\-version ]\fR                  Print the version and exit\.
\fB\-y, [ \-\-yaml ]\fR                     Output facts in YAML format\.
.
.fi
.
.SH "FILES"
.
.nf
\fI/etc/puppetlabs/facter/facter.conf\fR
.RS
A HOCON config file that can be used to specify directories for custom and external facts, set various command line options, and specify facts to block. See example below for details, or visit the GitHub README.
.
.SH "EXAMPLE"
Display all facts:
.
.IP "" 4
.
.nf

$ facter
disks => {
  sda => {
    model => "Virtual disk",
    size => "8.00 GiB",
    size_bytes => 8589934592,
    vendor => "ExampleVendor"
  }
}
dmi => {
  bios => {
    release_date => "06/23/2013",
    vendor => "Example Vendor",
    version => "6.00"
  }
}
[\.\.\.]
.
.fi
.
.IP "" 0
.
.P
Display a single structured fact:
.
.IP "" 4
.
.nf

$ facter processors
{
  count => 2,
  isa => "x86_64",
  models => [
    "Intel(R) Xeon(R) CPU E5-2680 v2 @ 2.80GHz",
    "Intel(R) Xeon(R) CPU E5-2680 v2 @ 2.80GHz"
  ],
  physicalcount => 2
}
.
.fi
.
.IP "" 0
.
.P
Display a single fact nested within a structured fact:
.
.IP "" 4
.
.nf
$ facter processors.isa
x86_64
.
.fi
.
.IP "" 0
.
.P
Display a single legacy fact. Note that non-structured facts existing in previous versions of Facter are still available,
but are not displayed by default due to redundancy with newer structured facts:
.
.IP "" 4
.
.nf
$ facter processorcount
2
.
.fi
.
.IP "" 0
.
.P
Format facts as JSON:
.
.IP "" 4
.
.nf

$ facter \-\-json os.name os.release.major processors.isa
{
  "os.name": "Ubuntu",
  "os.release.major": "14.04",
  "processors.isa": "x86_64"
}
.
.fi
.
.IP "" 0
.
.P
An example config file.
.
.IP "" 4
.
.nf

# always loaded (CLI and as Ruby module)
global : {
    external-dir : "~/external/facts",
    custom-dir   :  [
       "~/custom/facts",
       "~/custom/facts/more-facts"
    ],
    no-external-facts : false,
    no-custom-facts   : false,
    no-ruby           : false
}
# loaded when running from the command line
cli : {
    debug     : false,
    trace     : true,
    verbose   : false,
    log-level : "info"
}
# always loaded, fact-sepcific configuration
facts : {
    # for valid blocklist entries, see fact schema
    blocklist : [ "file system", "EC2" ],
}
.
.fi
.
.IP "" 0
.SH "AUTHOR"
Luke Kanies
.
.SH "COPYRIGHT"
Copyright (c) 2011\-2015 Puppet Labs, Inc Licensed under the Apache 2\.0 license
.
